Translates an array of text strings from one language to another.
The request body is of type TranslateArray.
Request Body Parameters
Overview
 |
 |
Sequence
|
appId optional xs:string
A string containing "Bearer" + " " + access token.
|
|
texts optional ArrayOfstring Complex Type
A string array representing the text from an unknown language. The size of the text must not exceed 10000 characters.
|
Sequence
| |
|
from optional xs:string
A string containing the language code of the source language. Must be a valid culture name.
|
|
to optional xs:string
A string containing the language code of the target language. Must be a valid culture name.
|
|
options optional TranslateOptions Complex Type
A TranslateOptions element containing the values below. They are all optional and default to the most common settings.
- Category: A string containing the category (domain) of the translation. Defaults to "general".
- ContentType: The format of the text being translated. The supported formats are "text/plain" and "text/html". Any HTML needs to be well-formed.
- Uri: A string containing the content location of this translation.
- User: A string used to track the originator of the submission.
- State: User state to help correlate request and response. The same contents will be returned in the response.
|
Sequence
|
Category optional xs:string
A string containing the category (domain) of the translation. Defaults to "general".
|
|
ContentType optional xs:string
A string containing the type of content. Either "text/html" or "text/plain". Defaults to "text/plain".
|
|
State optional xs:string
User state to help correlate request and response. The same contents will be returned in the response.
|
|
Uri optional xs:string
A string containing the content location of this translation.
|
|
User optional xs:string
A string used to track the originator of the submission.
| | | | |
The response body is of type TranslateArrayResponse.
A string representing the translated text. If you previously use AddTranslation or AddTranslationArray to enter a translation with a rating of 5 or higher for the same source sentence, Translate returns only the top choice that is available to your system. The "same source sentence" means the exact same (100% matching), except for capitalization, white space, tag values, and punctuation at the end of a sentence. If no rating is stored with a rating of 5 or above then the returned result will be the automatic translation by Microsoft Translator.Response Body Parameters
Overview
|
|
Sequence
|
|
Sequence
|
|
Sequence
|
Error optional xs:string
Indicates an error if one has occurred. Otherwise set to null.
|
|
From optional xs:string
A string containing the language code of the source language. Must be a valid culture name.
|
|
|
Sequence
| |
|
State optional xs:string
User state to help correlate request and response. Returns the same content as in the request.
|
|
|
Sequence
| | | | | | | |